Metadata-Version: 2.1
Name: OpenVAS Reporting
Version: 1.2.3
Summary: A tool to convert OpenVAS XML into reports.
Home-page: https://github.com/TheGroundZero/openvasreporting
Author: TheGroundZero (@DezeStijn)
Author-email: 2406013+TheGroundZero@users.noreply.github.com
License: GPL-3.0-or-later
Project-URL: Source Code, https://github.com/TheGroundZero/openvasreporting
Project-URL: Documentation, https://openvas-reporting.stijncrevits.be
Project-URL: Issues, https://github.com/TheGroundZero/openvas_to_report/issues/
Description: # OpenVAS Reporting:  
        
        [![GitHub version](https://badge.fury.io/gh/TheGroundZero%2Fopenvasreporting.svg)](https://badge.fury.io/gh/TheGroundZero%2Fopenvasreporting)
        [![License](https://img.shields.io/github/license/TheGroundZero/openvasreporting.svg)](https://github.com/TheGroundZero/openvasreporting/blob/master/LICENSE)
        [![Docs](https://readthedocs.org/projects/openvas-reporting/badge/?version=latest&style=flat)](https://openvas-reporting.stijncrevits.be)
        [![Known Vulnerabilities](https://snyk.io/test/github/TheGroundZero/openvasreporting/badge.svg?targetFile=requirements.txt)](https://snyk.io/test/github/TheGroundZero/openvasreporting?targetFile=requirements.txt)
        [![codecov](https://codecov.io/gh/TheGroundZero/openvasreporting/branch/master/graph/badge.svg)](https://codecov.io/gh/TheGroundZero/openvasreporting)
        [![Requirements Status](https://requires.io/github/TheGroundZero/openvasreporting/requirements.svg?branch=master)](https://requires.io/github/TheGroundZero/openvasreporting/requirements/?branch=master)
        [![PyPI - Format](https://img.shields.io/pypi/format/OpenVAS-Reporting.svg)](https://pypi.org/project/OpenVAS-Reporting/)
        [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/OpenVAS-Reporting.svg)](https://pypi.org/project/OpenVAS-Reporting/)
        
        A tool to convert [OpenVAS](http://www.openvas.org/) XML into reports.
        
        ![Report example screenshot](docs/_static/img/OpenVASreporting.png?raw=true)
        
        *Read the full documentation at [https://openvas-reporting.stijncrevits.be](https://openvas-reporting.stijncrevits.be)*
        
        I forked [OpenVAS2Report](https://github.com/cr0hn/openvas_to_report) since it didn't manage to convert all reports I threw at it
        and because I wanted to learn how to use Python for working with XML and creating Excel files.  
        Also, OpenVAS mixes their own threat levels with the [CVSS](https://www.first.org/cvss/) scoring, the latter of which I prefer to use in my reports.
        
        Looking for a fix and providing an actual fix through a pull request would have been too much work,
        so I chose to fork the repo and try my own thing.  
        I reorganised some of the files, removed some functionality and added some extra, and rewrote some functions.
        
        At this moment in time, the script only output .xlsx documents in one format, this may (not) change in the future.
        
        
        ## Requirements
        
         - [Python](https://www.python.org/) version 3
         - [XlsxWriter](https://xlsxwriter.readthedocs.io/)
         - [Python-docx](https://python-docx.readthedocs.io)
        
        
        ## Installation
        
            # install requirements
            apt(-get) install python3 python3-pip # Debian, Ubuntu
            yum -y install python3 python3-pip    # CentOS
            dnf install python3 python3-pip       # Fedora
            pip3 install -r requirements.txt
            # clone repo
            git clone git@github.com:TheGroundZero/openvas_to_report.git
        
        
        ## Usage
        
            python3 -m openvasreporting -i [OpenVAS xml file(s)] [-o [Output file]] [-f [Output format]] [-l [minimal threat level (n, l, m, h, c)]]
        
        ### Parameters
        
        | Short param | Long param | Description     | Required | Default value  |
        | :---------: | :--------- | :-------------- | :------: | :------------- |
        | -i          | --input    | Input file(s)   | YES      | n/a            |
        | -o          | --output   | Output filename | No       | openvas_report |
        | -f          | --format   | Output format   | No       | xlsx           |
        | -l          | --level    | Minimal level   | No       | n              |
        
        
        ## Examples
        
        ### Create Excel report from 1 OpenVAS XML report using default settings
        
            python3 -m openvasreporting -i openvasreport.xml -f xlsx
        
        ### Create Excel report from multiple OpenVAS reports using default settings
        
            # wildcard select
            python3 -m openvasreporting -i *.xml -f xlsx
            # selective
            python3 -m openvasreporting -i openvasreport1.xml -i openvasreport2.xml -f xlsx
        
        ### Create Excel report from multiple OpenVAS reports, reporting only threat level high and up
        
            python3 -m openvasreporting -i *.xml -o excelreport -f xlsx -l h
        
        ## Result
        
        The final report (in Excel format) will then look something like this:
        
        ![Report example screenshot - Summary](docs/_static/img/screenshot-report.png?raw=true)
        ![Report example screenshot - ToC](docs/_static/img/screenshot-report1.png?raw=true)
        ![Report example screenshot - Vuln desc](docs/_static/img/screenshot-report2.png?raw=true)
        
        Worksheets are sorted according to CVSS score and are colored according to the vulnerability level.
        
        ## Ideas
        
        Some of the ideas I still have for future functionality:
        
         - list vulnerabilities per host
         - make pip installer
         - filter by host (scope/exclude) as in OpenVAS2Report
         - export to other formats (CSV, PDF)
         - select threat levels individually (e.g. none and low; but not med, high and crit)
         
        
Keywords: OpenVAS OpenVAS-reports Excel xlsxwriter xlsx reporting reports report
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Framework :: Sphinx
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: Other Audience
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Natural Language :: English
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX
Classifier: Operating System :: Unix
Classifier: Programming Language :: Python
Classifier: Topic :: Documentation :: Sphinx
Classifier: Topic :: Internet :: Log Analysis
Classifier: Topic :: Security
Requires-Python: ~=3.7
Description-Content-Type: text/markdown
